home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / pdr.z / pdr
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppddddrrrr((((3333GGGG))))                                                                ppppddddrrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppddddrrrr,,,, ppppddddrrrriiii,,,, ppppddddrrrrssss,,,, ppppddddrrrr2222,,,, ppppddddrrrr2222iiii,,,, ppppddddrrrr2222ssss - specifies the next point of a
  10.      polygon
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd ppppddddrrrr((((xxxx,,,, yyyy,,,, zzzz))))
  14.      CCCCoooooooorrrrdddd xxxx,,,, yyyy,,,, zzzz;;;;
  15.  
  16.      vvvvooooiiiidddd ppppddddrrrriiii((((xxxx,,,, yyyy,,,, zzzz))))
  17.      IIIIccccoooooooorrrrdddd xxxx,,,, yyyy,,,, zzzz;;;;
  18.  
  19.      vvvvooooiiiidddd ppppddddrrrrssss((((xxxx,,,, yyyy,,,, zzzz))))
  20.      SSSSccccoooooooorrrrdddd xxxx,,,, yyyy,,,, zzzz;;;;
  21.  
  22.      vvvvooooiiiidddd ppppddddrrrr2222((((xxxx,,,, yyyy))))
  23.      CCCCoooooooorrrrdddd xxxx,,,, yyyy;;;;
  24.  
  25.      vvvvooooiiiidddd ppppddddrrrr2222iiii((((xxxx,,,, yyyy))))
  26.      IIIIccccoooooooorrrrdddd xxxx,,,, yyyy;;;;
  27.  
  28.      vvvvooooiiiidddd ppppddddrrrr2222ssss((((xxxx,,,, yyyy))))
  29.      SSSSccccoooooooorrrrdddd xxxx,,,, yyyy;;;;
  30.  
  31.      All of the above routines are functionally the same.  They differ only in
  32.      the type declarations of their parameters and in whether they expect a
  33.      two- or three-dimensional space.
  34.  
  35. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  36.      _x   expects the _x coordinate of the next defining point for the polygon.
  37.  
  38.      _y   expects the _y coordinate of the next defining point for the polygon.
  39.  
  40.      _z   expects the _z coordinate of the next defining point for the polygon.
  41.  
  42. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  43.      ppppddddrrrr specifies the next point of a polygon.  When ppppddddrrrr is executed, it
  44.      draws a line to the specified point (_x,_y,_z) which then becomes the
  45.      current graphics position.  The next ppppddddrrrr call will start drawing from
  46.      that point.  To draw a typical polygon start with ppppmmmmvvvv, follow it with a
  47.      sequence of calls to ppppddddrrrr and end it with ppppcccclllloooossss.
  48.  
  49. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  50.      The following sequence draws a square:
  51.  
  52.           pmv(0.0, 0.0, 0.0);
  53.           pdr(1.0, 0.0, 0.0);
  54.           pdr(1.0, 1.0, 0.0);
  55.           pdr(0.0, 1.0, 0.0);
  56.           pclos();
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppddddrrrr((((3333GGGG))))                                                                ppppddddrrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      bgnpolygon, endpolygon, pclos, pmv, v
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      ppppddddrrrr should not be used in new development.  Rather, polygons should be
  79.      drawn using the high-performance vvvv commands, surrounded by calls to
  80.      bbbbggggnnnnppppoooollllyyyyggggoooonnnn and eeeennnnddddppppoooollllyyyyggggoooonnnn.
  81.  
  82.      There can be no more than 256 vertices in a polygon.  Therefore, there
  83.      can be no more than 255 ppppddddrrrr calls between ppppmmmmvvvv and ppppcccclllloooossss.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.